package com.skyeye.mapper;

import com.skyeye.entity.User;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 用户数据访问层接口
 * 使用MyBatis进行数据库操作
 */
public interface UserMapper {
    
    /**
     * 插入用户
     * @param user 用户对象
     * @return 影响行数
     */
    int insertUser(User user);
    
    /**
     * 根据ID删除用户
     * @param id 用户ID
     * @return 影响行数
     */
    int deleteUserById(@Param("id") Integer id);
    
    /**
     * 更新用户信息
     * @param user 用户对象
     * @return 影响行数
     */
    int updateUser(User user);
    
    /**
     * 根据ID查询用户
     * @param id 用户ID
     * @return 用户对象
     */
    User selectUserById(@Param("id") Integer id);
    
    /**
     * 根据用户名查询用户
     * @param username 用户名
     * @return 用户对象
     */
    User selectUserByUsername(@Param("username") String username);
    
    /**
     * 查询所有用户
     * @return 用户列表
     */
    List<User> selectAllUsers();
    
    /**
     * 根据年龄范围查询用户
     * @param minAge 最小年龄
     * @param maxAge 最大年龄
     * @return 用户列表
     */
    List<User> selectUsersByAgeRange(@Param("minAge") Integer minAge, @Param("maxAge") Integer maxAge);
    
    /**
     * 根据邮箱查询用户
     * @param email 邮箱
     * @return 用户对象
     */
    User selectUserByEmail(@Param("email") String email);
    
    /**
     * 统计用户总数
     * @return 用户总数
     */
    int countUsers();
    
    /**
     * 根据用户名模糊查询
     * @param username 用户名关键字
     * @return 用户列表
     */
    List<User> selectUsersByUsernameLike(@Param("username") String username);
    
    /**
     * 批量插入用户
     * @param users 用户列表
     * @return 影响行数
     */
    int batchInsertUsers(@Param("list") List<User> users);
}
